uxstr FTP GET - Récupérer des fichiers

Cette section décrit la commande uxstr FTP GET utilisée pour récupérer des fichiers d'un serveur FTP.

Cette commande permet de récupérer un ou plusieurs fichiers sur un serveur FTP. Sa syntaxe est la suivante :

uxstr FTP GET PARTNER=hostname [ORIGIN_FILENAME=filename] [ORIGIN_PATHNAME=path] [TARGET_FILENAME=filename] [TARGET_PATHNAME=path] [LOGON=username] [PASSWORD=password] [MODE=ASCII|BINARY] [ACTION=REPLACE|ABORT|NONE] [CRLF|NOCRLF] [DELETE|NODELETE] [NEWER|NONEWER] [RECURSIVE|NORECURSIVE] [BUFFER_SIZE=nn] [RETRY=n] [UMASK=nnn]

Description des items

• PARTNER=

  Nom physique de la machine cible ou adresse IP.
  Format : 255 caractères alphanumériques

• ORIGIN_FILENAME=

  (Optionnel) Nom du fichier distant à récupérer.
  Format : 256 caractères alphanumériques

  Défaut : tous les fichiers du répertoire.

• ORIGIN_PATHNAME=

  (Optionnel) Répertoire distant.
  Format 256 caractères alphanumériques. Caractère * interdit. Les chemins doivent être écrits comme des chemins de commande FTP, par exemple le chemin "C:\Temp\Transfer" doit être écrit: "C:/Temp/Transfer".

  Défaut : répertoire de connexion de l'utilisateur FTP.

• TARGET_FILENAME=

  (Optionnel) Nom du fichier local.
  Format : 256 caractères alphanumériques

  Défaut : nom inchangé

• TARGET_PATHNAME=

  (Optionnel) Nom du répertoire local de réception des fichiers.
  Format : 256 caractères alphanumériques. Caractère * interdit.

  Défaut : nom du répertoire de connexion du compte de soumission de l'Uproc.

• LOGON=

  (Optionnel) Utilisateur de connexion FTP.
  Format : 32 caractères alphanumériques.

  Défaut : anonymous

• PASSWORD=

  (Optionnel) Mot de passe de l'utilisateur de connexion FTP. Le mot de passe est invisible dans l'interface graphique.
  Format : 32 caractères alphanumériques

• MODE=

  (Optionnel) Type de transfert : ASCII ou BINARY.

  Défaut : ASCII

• ACTION=

  (Optionnel) Comportement si le fichier cible existe déjà :

  • REPLACE : remplacer le fichier existant.
  • ABORT : annuler le transfert et sortir en erreur.
  • NONE : ne rien faire.

  Défaut : ABORT

• CRLF | NOCRLF

  (Optionnel) Conversion des caractères CR. L’option CRLF n’est pas disponible pour FTP_PUT.

  • CRLF: tous les caractères CR sont convertis en LF durant le transfert ASCII.
  • NOCRLF: pas de conversion durant le transfert ASCII. sauf pour les soumissions.

  Défaut :NOCRLF

• DELETE | NODELETE

  (Optionnel) Suppression du fichier origine

  • DELETE: supprime le fichier origine si le transfert est réussi.
  • NODELETE : le fichier origine n'est pas supprimé si le transfert est réussi.

  Défaut : NODELETE

• NEWER | NONEWER

  (Optionnel) Vérification de la date du fichier

  • NEWER : transfère le fichier si sa date de modification est plus récente que celle du fichier cible.
  • NONEWER : transfère le fichier quelle que soit sa date.

  Défaut : NONEWER

  Attention ! Cette option n'est pas supportée par défaut par SFTP. Pour savoir si SFTP a été configuré, reportez-vous à la valeur du paramètre nœud U_FT_SFTP. U_FT_SFTP.

• RECURSIVE | NORECURSIVE

  (Optionnel) Fichiers transférés

  • RECURSIVE : transfère tous les fichiers et sous-répertoires contenus dans le chemin ORIGIN_PATHNAME (les paramètres ORIGIN_FILENAME et TARGET_FILENAME ne doivent plus être saisis). Le nombre de niveaux de répertoires ne doit pas dépasser 150.
  • NORECURSIVE : seuls les fichiers du répertoire courant sont transférés.

  Défaut : NORECURSIVE.

  L'option RECURSIVE utilise en interne la commande FTP LIST pour obtenir la liste des fichiers et des répertoires du serveur distant. La réponse attendue du serveur doit être formatée de telle sorte que chaque ligne doit commencer par les droits des fichiers au format UNIX. Cette réponse variant d'un serveur à un autre, la fonction ne pourra pas être utilisée si la réponse a un format différent. Dans ce cas, un fonctionnement dégradé peut être utilisé : chaque fichier du serveur distant est testé à l'aide d'une commande FTP CWD pour vérifier l'existence d'un répertoire. Ce fonctionnement dégradé est moins performant mais il peut être activé à l'aide du paramètre nœud U_FT_GET_DIR_FAILOVER dans la catégorie "Paramètres nœud – Paramétrage FTP".

  • Lors de la récupération d'un répertoire en mode RECURSIVE à l'aide d'une Uproc FTP_GET, le mode Append n'est pas supporté, l'action Abort est utilisée par défaut.

• BUFFER_SIZE=

  (Optionnel) Définit la taille du buffer de communication en blocs de 512 octets.
  Format : nombre entier pair entre 1 et 64.

  Défaut : défaut FTP

• RETRY=

  (Optionnel) Nombre d'essais en cas d'échec de transmission.
  Format : 1 caractère numérique.

• UMASK=

  (Optionnel) Masque appliqué aux permissions du fichier local. Si UMASK n'est pas défini ou est défini à 000, les fichiers sont téléchargés par défaut avec les permissions 666 (pour un utilisateur root) ou 640 (pour un utilisateur non-root). Sinon, les permissions du fichier sont obtenues en soustrayant UMASK de la valeur par défaut (666 ou 640).
  Format : 3 caractères numériques.

Exemple

• Récupère tous les fichiers du répertoire tmp sur l'hôte Win en mode binaire en appliquant un masque 700 et remplace les fichiers existants :

  uxstr FTP GET PARTNER=”Win” ORIGIN_PATHNAME=”/tmp/” MODE=BINARY UMASK=700 ACTION=REPLACE RETRY=3